Documentation fixes

diff --git a/docs/reference/gdk/gdk3-sections.txt b/docs/reference/gdk/gdk3-sections.txt
index ebfc9d1463e473d7d41a570a5b39fa2d0b44a8e4..dc0413d65fd91ce0d7d23a44188d15945687fa20 100644 (file)
--- a/docs/reference/gdk/gdk3-sections.txt
+++ b/docs/reference/gdk/gdk3-sections.txt
@@ -809,9 +809,8 @@ gdk_event_get_scroll_direction
 gdk_event_get_scroll_deltas
 gdk_event_get_state
 gdk_event_get_time
-gdk_event_get_event_type
 gdk_event_get_window
-gdk_event_get_type
+gdk_event_get_event_type
 GdkEventSequence
 gdk_event_get_event_sequence
 gdk_event_request_motions

diff --git a/gdk/gdkcairo.c b/gdk/gdkcairo.c
index 67fc35acad8502679920c74536fa34130c29412b..5dba69a8f70155fe81600ee025dac2bc3afeadb5 100644 (file)
--- a/gdk/gdkcairo.c
+++ b/gdk/gdkcairo.c
@@ -157,7 +157,7 @@ gdk_cairo_rectangle (cairo_t            *cr,
  * Since: 2.8
  */
 void
-gdk_cairo_region (cairo_t         *cr,
+gdk_cairo_region (cairo_t              *cr,
                   const cairo_region_t *region)
 {
   cairo_rectangle_int_t box;
@@ -184,12 +184,14 @@ gdk_cairo_region (cairo_t         *cr,
  * Creates an image surface with the same contents as
  * the pixbuf.
  *
+ * Returns: a new cairo surface, must be freed with cairo_surface_destroy()
+ *
  * Since: 3.10
  */
 cairo_surface_t *
 gdk_cairo_surface_create_from_pixbuf (const GdkPixbuf *pixbuf,
-                                      int scale,
-                                      GdkWindow *for_window)
+                                      int              scale,
+                                      GdkWindow       *for_window)
 {
   gint width = gdk_pixbuf_get_width (pixbuf);
   gint height = gdk_pixbuf_get_height (pixbuf);

diff --git a/gdk/gdkdnd.c b/gdk/gdkdnd.c
index 1614a3955434b501c39ffa4ac8e69be4da664fe9..559a31de7bcf2a5e867439494a1ad197074d767a 100644 (file)
--- a/gdk/gdkdnd.c
+++ b/gdk/gdkdnd.c
@@ -315,6 +315,8 @@ gdk_drag_status (GdkDragContext *context,
  * set of actions changes.
  *
  * This function is called by the drag source.
+ *
+ * Returns:
  */
 gboolean
 gdk_drag_motion (GdkDragContext *context,

diff --git a/gdk/gdkwindow.c b/gdk/gdkwindow.c
index a07d3b44c3c1d72d4b54c89a3a4cc698b2543741..f096101015db97598fcb04167945aaeaf6e4eadf 100644 (file)
--- a/gdk/gdkwindow.c
+++ b/gdk/gdkwindow.c
@@ -2422,10 +2422,10 @@ gdk_window_peek_children (GdkWindow *window)
 /**
  * gdk_window_get_children_with_user_data:
  * @window: a #GdkWindow
- * @user_data: 
+ * @user_data: user data to look for
  *
- * Gets the list of children of @window known to GDK with a particular
- * @user_data set on it.
+ * Gets the list of children of @window known to GDK with a
+ * particular @user_data set on it.
  *
  * The returned list must be freed, but the elements in the
  * list need not be.

diff --git a/gdk/x11/gdkwindow-x11.c b/gdk/x11/gdkwindow-x11.c
index b11909f8c0b273c6b70bce82da4637d38983a0e5..a5c4507cb629d99dc845a736891c87e74d3a38fc 100644 (file)
--- a/gdk/x11/gdkwindow-x11.c
+++ b/gdk/x11/gdkwindow-x11.c
@@ -2156,6 +2156,16 @@ get_netwm_cardinal_property (GdkWindow   *window,
   return prop;
 }
 
+/**
+ * gdk_x11_window_get_desktop:
+ * @window: a #GdkWindow
+ *
+ * Gets the number of the workspace @window is on.
+ *
+ * Returns: the current workspace of @window
+ *
+ * Since: 3.10
+ */
 guint32
 gdk_x11_window_get_desktop (GdkWindow *window)
 {